home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmStringGenerate.z / XmStringGenerate
Text File  |  1998-10-30  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeennnneeeerrrraaaatttteeee((((3333XXXX))))      UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV      XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeennnneeeerrrraaaatttteeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeennnneeeerrrraaaatttteeee - A convenience function that generates a
  10.           compound string
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           XXXXmmmmSSSSttttrrrriiiinnnngggg XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeennnneeeerrrraaaatttteeee(
  15.           XXXXttttPPPPooooiiiinnnntttteeeerrrr tttteeeexxxxtttt,
  16.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaagggg ttttaaaagggg,
  17.           XXXXmmmmTTTTeeeexxxxttttTTTTyyyyppppeeee ttttyyyyppppeeee,
  18.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaagggg rrrreeeennnnddddiiiittttiiiioooonnnn);
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents Motif 2.1.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeennnneeeerrrraaaatttteeee calls the XXXXmmmmSSSSttttrrrriiiinnnnggggPPPPaaaarrrrsssseeeeTTTTeeeexxxxttttfunction with a
  25.           default parse table of entries consisting of '0', which maps
  26.           to Separator, and '', which maps to Tab.  Matching
  27.           _R_E_N_D_I_T_I_O_N__B_E_G_I_N and _R_E_N_D_I_T_I_O_N__E_N_D components containing
  28.           _r_e_n_d_i_t_i_o_n are placed around the resulting XXXXmmmmSSSSttttrrrriiiinnnngggg.
  29.  
  30.           _t_e_x_t      Specifies a NULL-terminated string containing
  31.                     characters of a type determined by _t_y_p_e.
  32.  
  33.           _t_a_g       Specifies the tag to be used in creating the
  34.                     result. The type of tag created (charset or
  35.                     locale) depends on the text type and the value
  36.                     given. If specified value is NULL, and _t_y_p_e
  37.                     indicates that a charset tag should be created,
  38.                     then the tag will have the value of
  39.                     XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG.  If _t_a_g is NULL, and _t_y_p_e
  40.                     indicates a locale tag, then the tag will have the
  41.                     value of ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____LLLLOOOOCCCCAAAALLLLEEEE.
  42.  
  43.           _t_y_p_e      Specifies the type of text to be passed in, and
  44.                     the tag type.  If a locale tag should be created,
  45.                     then _t_y_p_e has a value of either XXXXmmmmMMMMUUUULLLLTTTTIIIIBBBBYYYYTTTTEEEE____TTTTEEEEXXXXTTTT
  46.                     or XXXXmmmmWWWWIIIIDDDDEEEECCCCHHHHAAAARRRR____TTTTEEEEXXXXTTTT. If a charset should be
  47.                     created, _t_y_p_e has a value of XXXXmmmmCCCCHHHHAAAARRRRSSSSEEEETTTT____TTTTEEEEXXXXTTTT.
  48.  
  49.           _r_e_n_d_i_t_i_o_n Specifies the rendition tag to be used in an
  50.                     XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____RRRREEEENNNNDDDDIIIITTTTIIIIOOOONNNN____BBBBEEEEGGGGIIIINNNN component which
  51.                     will begin the returned string and in an
  52.                     XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____RRRREEEENNNNDDDDIIIITTTTIIIIOOOONNNN____EEEENNNNDDDDcomponent which
  53.                     will end it.  If _r_e_n_d_i_t_i_o_n is NULL, no rendition
  54.                     tag is placed.
  55.  
  56.      RRRREEEETTTTUUUURRRRNNNN
  57.           Returns a new compound string.  The function will allocate
  58.           space to hold the returned compound string.  When the
  59.           application no longer needs the returned compound string,
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeennnneeeerrrraaaatttteeee((((3333XXXX))))      UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV      XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeennnneeeerrrraaaatttteeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           the application should call XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee.
  75.  
  76.      RRRREEEELLLLAAAATTTTEEEEDDDD
  77.           XXXXmmmmSSSSttttrrrriiiinnnngggg(3) and XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee(3).
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.